home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / rvb_10.zip / RIPVOTE.DOC < prev    next >
Text File  |  1993-06-27  |  14KB  |  345 lines
  1.  
  2.  
  3.  
  4.                              RIP Voting Booth
  5.                              ^^^^^^^^^^^^^^^^
  6.                         COPYRIGHT 1993 T&J Software
  7.                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  8.  
  9.         One of the T&J Software Collection of multi-BBS door programs.
  10.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  11.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  12.  
  13.                               VERSION 1.0
  14.                               ^^^^^^^^^^^
  15.                              June 27, 1993
  16.                              ^^^^^^^^^^^^^
  17.                                    By
  18.  
  19.                             Tom & Jane Wildoner
  20.                              397 West Broadway
  21.                               Jim Thorpe, PA
  22.                                   18229
  23.                             VOICE (717)325-9480
  24.                    *between 5:30 & 10:00 p.m. Eastern Time
  25.  
  26.                                   From
  27.  
  28.                                The T&J BBS
  29.                               (717)325-9481
  30.                         1200/2400/9600/19200/38400
  31.                                24 Hours/Day
  32.  
  33.  
  34. LATEST VERSION
  35. ^^^^^^^^^^^^^^
  36. Please call the T&J BBS for the latest version of this program.
  37.  
  38.  
  39. LEGALITIES
  40. ^^^^^^^^^^
  41. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  42. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  43. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  44. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  45. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  46. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY. ONCE REGISTERED, ANY
  47. DISTRIBUTION OF THE REGISTERED KEY WILL INVALIDATE YOUR KEY IN ALL FUTURE
  48. VERSIONS OF THIS PROGRAM AND NO PRODUCT SUPPORT WILL BE GIVEN. DISTRIBUTING
  49. A REGISTERED KEY FILE WILL ALSO BRING ABOUT CRIMINAL CHARGES.
  50.  
  51.  
  52. DISTRIBUTION
  53. ^^^^^^^^^^^^
  54. You may make this file available for downloading from your BBS or you may
  55. upload it to any BBS of your choice, provided that you do not make any
  56. changes to the contents of the archive (ZIP file). The archive and its
  57. individual contents may not be used by any service that charges any money
  58. whatsoever, without the written permission of the author.
  59.  
  60.  
  61. PROGRAM DESCRIPTION
  62. ^^^^^^^^^^^^^^^^^^^
  63. Welcome to T&J Software's RIP Voting Booth! RIP Voting Booth allows
  64. you to place up to 10 RIP Graphics Screens on display for your
  65. users to vote on. Great for online competition between users!
  66.  
  67. The voting option is disabled until registered.
  68.  
  69.  
  70. ADDITIONAL NOTES
  71. ^^^^^^^^^^^^^^^^
  72. This door does not expire! The door cannot be run "locally" by typing
  73. RIPVOTE LOCAL as with other doors from T&J Software.
  74.  
  75.  
  76. FEATURES
  77. ^^^^^^^^
  78. > Desqview Aware.
  79. > COM1-15 support and non-standard IRQ's.
  80. > Colorful RIP screens.
  81. > NO BRUN module needed for play.
  82. > Will return to BBS on dropped carrier.
  83. > Will TIMEOUT a player after 5 minutes of no activity.
  84. > Mouse support.
  85. > Use of HOT KEYS while in the door.
  86. > Support BBS available.
  87. > SysOp configurable.
  88. > Fossil Driver support.
  89. > Easy setup via the RIPUTIL program.
  90. > Supports all BBS types!
  91.  
  92.  
  93. INSTALLATION
  94. ^^^^^^^^^^^^
  95. Run the RIPUTIL.EXE program!!
  96.  
  97. Next, RESET the DOOR!! Select number 1 from the UTILITY menu! This
  98. will reset everything from scratch.
  99.  
  100. Next, select number 2 from the UTILITY menu and setup the RIP screens
  101. for your users to vote on --- RVB ships all ready with 10 RIP Graphic
  102. Screens to get you started!
  103.  
  104. Next, select number 3 and set up the RIPVOTE.CFG file -- answer all the
  105. questions here.
  106.  
  107. Finally, select number 4 to toggle the local display on or off. If
  108. your running a non RIP BBS package you may want to toggle the local
  109. display OFF or you will see nothing but garbage on the local monitor.
  110. Don't worry about it, the remote user is seeing things fine!
  111.  
  112.  
  113. CONFIGURATION (Your RIPVOTE.CFG file)
  114. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  115. Example configuration file for PCBOARD.SYS
  116. ------------------------------------------
  117. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  118. T&J Software        <=-  (Change this to your BBS name)
  119. Tom                 <=-  (The Sysop's first name)
  120. Wildoner            <=-  (The Sysop's last name)
  121.  
  122. Example configuration file for USERS.SYS
  123. ----------------------------------------
  124. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  125. T&J Software        <=-  (Change this to your BBS name)
  126. Tom                 <=-  (The Sysop's first name)
  127. Wildoner            <=-  (The Sysop's last name)
  128.  
  129. Example configuration file for DOOR.SYS
  130. ---------------------------------------
  131. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  132. T&J Software        <=-  (Change this to your BBS name)
  133. Tom                 <=-  (The Sysop's first name)
  134. Wildoner            <=-  (The Sysop's last name)
  135.  
  136. Example configuration file for USERINFO.DAT
  137. -------------------------------------------
  138. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  139. T&J Software        <=-  (Change this to your BBS name)
  140. Tom                 <=-  (The Sysop's first name)
  141. Wildoner            <=-  (The Sysop's last name)
  142. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  143.  
  144. Example configuration file for CALLINFO.BBS
  145. -------------------------------------------
  146. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  147. T&J Software        <=-  (Change this to your BBS name)
  148. Tom                 <=-  (The Sysop's first name)
  149. Wildoner            <=-  (The Sysop's last name)
  150.  
  151. Example configuration file for DORINFOx.DEF
  152. -------------------------------------------
  153. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  154.                           where 'x' is the BBS Node number.
  155. T&J Software        <=-  (Change this to your BBS name)
  156. Tom                 <=-  (The Sysop's first name)
  157. Wildoner            <=-  (The Sysop's last name)
  158.  
  159. Example configuration file for SFDOORS.DAT
  160. ------------------------------------------
  161. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  162. T&J Software        <=-  (Change this to your BBS name)
  163. Tom                 <=-  (The Sysop's first name)
  164. Wildoner            <=-  (The Sysop's last name)
  165.  
  166. Example configuration file for CHAIN.TXT
  167. ----------------------------------------
  168. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  169. T&J Software        <=-  (Change this to your BBS name)
  170. Tom                 <=-  (The Sysop's first name)
  171. Wildoner            <=-  (The Sysop's last name)
  172.  
  173. Example configuration file for GTUSER.BBS
  174. -----------------------------------------
  175. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  176. T&J Software        <=-  (Change this to your BBS name)
  177. Tom                 <=-  (The Sysop's first name)
  178. Wildoner            <=-  (The Sysop's last name)
  179. 1                   <=-  (COM port number - defaults to 1)
  180. 1                   <=-  (Node number - defaults to 1)
  181.  
  182. ** Please see your individual door documentation on setting up doors!
  183.  
  184.  
  185. Example Batch File
  186. ^^^^^^^^^^^^^^^^^^
  187. A sample batch file similar to the following:
  188.    ECHO OFF
  189.    CD\DOORS\RIPVOTE         <=- Switch to the door's Directory.
  190.    RIPVOTE RIPVOTE.CFG      <=- Execute the door program and pass the
  191.                                 configuration filename to the program.
  192.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  193.    BOARD                    <=- Restart BBS.
  194.  
  195. This Door is multi-node  compatible so you may run more than 1 node from
  196. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  197. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  198. variables, (q.v.)
  199.  
  200.  
  201. Environment Variables
  202. ^^^^^^^^^^^^^^^^^^^^^
  203. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  204. variables. Non-PCBoard systems may also use these variables by including
  205. the following in either your BBS batch or AUTOEXEC.BAT
  206.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  207.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  208. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  209. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  210. .CFG file for multi-node operation!
  211.  
  212. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  213. command line.  For example:
  214.  
  215.      RIPVOTE RIPVOTE.CFG /5
  216. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  217.      RIPVOTE RIPVOTE.CFG /%IRQ%
  218.  
  219. This tells the program to use IRQ 5 instead of the standard IRQ.
  220.  
  221.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  222.  systems. Seems Novell also uses the / character so something went screwy
  223.  somewhere. So I added the * (asterisk) which may be used instead of the /
  224.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  225.  and are interchangeable.
  226.  
  227. When specifying the location of the system file on line 1 of the doors .CFG
  228. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  229. and %wcnodeid%. Some examples:
  230.  PCBoard: 
  231.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  232.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  233.  
  234.  Wildcat!:
  235.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  236.  
  237. Non-PCBoard systems may use the PCB environment variables by setting them
  238. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  239.  SET PCBDRIVE=C:
  240.  SET PCBDIR=\BBSDIR
  241.  SET PCBNODE=1
  242.  
  243.  
  244. Fossil Driver Support
  245. ^^^^^^^^^^^^^^^^^^^^^
  246. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  247. Fossil driver instead of the standard COM ports, just put /FD on the command
  248. line when running the door. For example:
  249.      MYDOOR MYDOOR.CFG /FD
  250. indicates that a Fossil driver is present and should be used. If no Fossil
  251. driver is detected, DoorFrame will print a message to that effect and exit
  252. the door gracefully.
  253.  
  254.  
  255. Sysop Keys
  256. ^^^^^^^^^^
  257. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  258.          written to DOOR.SYS and USERS.SYS
  259. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  260.          and/or written to DOOR.SYS and USERS.SYS
  261. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  262. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  263.          and/or written to DOOR.SYS and USERS.SYS
  264. F8    -  Returns the caller involuntarily to the BBS.
  265. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  266.          and/or written to DOOR.SYS and USERS.SYS
  267. F10   -  Activates SysOp CHAT mode within the DOOR.
  268. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  269. UP    -  Give the caller extra time while in the DOOR.  
  270. DN    -  Subtract time from the caller while in the DOOR. 
  271. HOME  -  HELP key for Status Line options.
  272. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  273. ALT-X -  PCBoard will exit after current caller logs off. Value is
  274.          passed to PCBoard. Not available on non-PCBoard systems.
  275.  
  276.  
  277. SYSOP.CFG FILE
  278. ^^^^^^^^^^^^^^
  279. 10                            NUMBER OF RIP SCREENS YOU HAVE TO DISPLAY
  280. A RIP Car!                    DESCRIPTION OF SCREEN 1
  281. Being a SysOp!                                      2
  282. A picture of an eagle.                              3
  283. A monsterous picture!                               4
  284. Thanks to PEPSI!                                    5
  285. Picture of a goblin!                                6
  286. Mosaic scene....                                    7
  287. A Computer Board.                                   8
  288. City Lights!                                        9
  289. Star Trek!                                          10
  290. whitcar2.rip                  DOS FILENAME FOR SCREEN 1
  291. face1.rip                                             2
  292. eagle.rip                                             3
  293. monster.rip                                           4
  294. thanks.rip                                            5
  295. goblin.rip                                            6
  296. mosaic.rip                                            7
  297. cboard.rip                                            8
  298. city.rip                                              9
  299. stdemo.rip                                            10
  300.  
  301. The SYSOP.CFG file MUST have all 21 lines even if you only have
  302. 5 screens for the users to vote on!
  303.  
  304.  
  305. LDISPLAY.DAT File Structure
  306. ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  307. This file only has one number, either a -1 or a 0. -1 means the local
  308. display will be left on, and a 0 means the local display will be
  309. toggled OFF when a remote user enter the door.
  310.  
  311.  
  312. MAINTENANCE
  313. ^^^^^^^^^^^
  314. After the initial setup, no maintenance on your part is needed!
  315. The door will reset every monday!
  316.  
  317.  
  318. PLAYING LOCALLY
  319. ^^^^^^^^^^^^^^^
  320. Not possible because of the RIP Graphics!
  321.  
  322.  
  323. COMMENTS & QUESTIONS
  324. ^^^^^^^^^^^^^^^^^^^^
  325. Please see the file TJHELP.TXT for some helpful tips and tricks
  326. for some problems which we have come across. This file changes
  327. all the time, and the latest version of TJHELP.ZIP can always be
  328. found on our BBS.
  329.  
  330.  
  331. VERSION HISTORY
  332. ^^^^^^^^^^^^^^^
  333. See the HISTORY.TXT file for information on the history of the game
  334. and the new options in the new versions!
  335.  
  336.  
  337. REGISTERING
  338. ^^^^^^^^^^^
  339. That's all there is to it! If you have any problems or questions
  340. please feel free to call the T&J BBS at (717)325-9481 and join the
  341. T&J Software Conference.
  342.  
  343.  
  344. See the enclosed registration form for ordering!  (REGISTER.TXT)
  345.